home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #2 / Amiga Plus CD - 1995 - No. 2.iso / internet / faq / englisch / waffle < prev    next >
Encoding:
Text File  |  1995-04-11  |  72.5 KB  |  1,961 lines

  1. Archive-name: waffle-faq
  2. Original-Author: vds7789@aw2.fsl.ca.boeing.com (Vince Skahan)
  3. And-Then: fenner@cmf.nrl.navy.mil (Bill Fenner)
  4. And-Then: cbwfaq@alpha3.ersys.edmonton.ab.ca (Russell Schulz)
  5. Comp-bbs-waffle-archive-name: faq
  6. Posting-Frequency: biweekly
  7. Last-modified: 1995-02-22
  8.  
  9.  
  10.                     Waffle Frequently Asked Questions (FAQs)
  11.                     ========================================
  12.  
  13. Table of Contents:
  14.  
  15. Disclaimer
  16. Introduction
  17. Let's create a waffle replacement!
  18. General information
  19. Licensing
  20. Availability
  21. Support mechanism
  22. Mail
  23. Files section
  24. Externals
  25. Editors
  26. News
  27. Administering a usenet site
  28. Communications
  29. Aftermarket add-ons
  30. Miscellaneous
  31. Waffle bugs
  32. Transition to 1.65
  33. Waffle and OS/2
  34. Waffle and wwivedit
  35. Waffle and kermit
  36. Getting waffle files via mail-based archive servers
  37. Getting waffle files via anonymous uucp
  38. Making waffle menu-driven
  39. What can i do about uuxqt/rnews hanging on long Path: headers?
  40. Why do i get Error 5 deleting call file?
  41. What is the difference between access level and privelege level?
  42. Why does waffle complain about `truncated batch'?
  43. How can I set up a mailing list?  Waffle won't let me have more than 20?
  44. How can I set up a info@ auto-reply mechanism?
  45. What changes are needed for the new free BSD systems?
  46. How can I get RIP graphics on waffle for $2?
  47.  
  48.  
  49.  
  50. ------------------------------
  51.  
  52. Subject: waffle: Disclaimer
  53. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  54.  
  55. Read at your own risk.  The current, previous, or original authors
  56. make no claim as to fitness for any purpose or absence of any errors,
  57. and offer no warranty.  Do not eat.
  58.  
  59. use of the first person (`I') in this document may be remnants of
  60. earlier authors' comments.  please check this before assuming that
  61. the current maintainer wrote everything herein (I didn't).
  62.  
  63.  
  64. ------------------------------
  65.  
  66. Subject: waffle: Introduction
  67. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  68.  
  69. The intent of this document is to assemble, in one place, a general list
  70. of Waffle-related Frequently Asked Questions.  It is not intended to be
  71. all-inclusive, since no one document can replace the 400KB or so of
  72. documents that come with Waffle.
  73.  
  74. Rather than repeat material maintained in other newsgroups, other periodic
  75. postings, or the \waffle\docs directory, this document will attempt to
  76. point the reader to the right place for information that is either too
  77. complicated to describe here, or is kept up to date elsewhere.
  78.  
  79. In particular, lists of software packages available, their authors,
  80. and their ftp locations are kept in the comp.os.msdos.mail-news FAQ.
  81.  
  82. This document includes information for the current official release of 
  83. Waffle (v1.65, released 8/1/92).
  84.  
  85. In many cases, the answer to a FAQ might be something along the lines of 
  86. "you can't at v1.64 or before".  Version-specific answers are indicated 
  87. whenever possible.
  88.  
  89. At this time, this document primarily addresses the DOS version of Waffle, 
  90. but feel free to submit unix-Waffle FAQs to the address above for inclusion 
  91. in the next posting.
  92.  
  93. Comments, additions, and corrections are welcomed (via e-mail please).
  94.  
  95. This FAQ should probably be split.  at least it's now a minimal digest.
  96.  
  97.  
  98. ------------------------------
  99.  
  100. Subject: waffle: Let's create a waffle replacement!
  101. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  102.  
  103. well, ok, if you must.  but the best group to discuss this, unless
  104. you're planning on just a waffle clone (and why bother?  it's already
  105. available) is probably NOT comp.bbs.waffle -- comp.os.msdos.mail-news
  106. was created in part to get this discussion OUT of comp.bbs.waffle.
  107.  
  108. ------------------------------
  109.  
  110. Subject: waffle: General information
  111. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  112.  
  113. 1. What is Waffle ?
  114.  
  115.         Waffle is a USENET-compatible BBS system which supports UUCP
  116.         mail, UUCP, and USENET news.  In addition, there is a built-in
  117.         editor, file upload/download, and the ability to hook in
  118.         external programs and gateway to (or from) other packages.
  119.  
  120.         DOS Waffle supports (but does not require) external Fossil
  121.         drivers to allow use of high speed modems and allows an MSDOS
  122.         PC to be a fully RFC compliant USENET node.  It also provides
  123.         the UUCP-based transport mechanism that generally comes with
  124.         unix systems.
  125.  
  126.         Unix Waffle provides just the BBS functionality and requires the 
  127.         'traditional' unix communications, mail, and USENET-news software 
  128.         for those functions.
  129.  
  130.         See \waffle\docs\readme, unix.doc, and dos.doc for more details.
  131.  
  132. 2. What operating systems does it run on ?
  133.  
  134.         IBM-PCs and compatibles running MSDOS (which includes Microsoft
  135.                 Windows, DR-DOS, and OS/2 if you have enough memory).
  136.  
  137.         Many variants of unix.  In particular, configuration options are
  138.         already in place for: NeXT, BSD 4.2/4.3, A/UX, SUN, LINUX, IRIS,
  139.         Ultrix, XENIX, Interactive 386/ix, HP/UX, Altos 2000.  If you
  140.         have one of these environments, Waffle should just drop in with
  141.         no problems.
  142.  
  143. 3. When is the next version coming out?
  144.  
  145.         No one knows.  Tom Dell has been very busy at work for quite a
  146.         while, and that has to take priority over working on waffle.
  147.         The jump from 1.64 to 1.65 took a year and a half, and it's now
  148.         been over two years since 1.65 came out.
  149.  
  150.  
  151. ------------------------------
  152.  
  153. Subject: waffle: Licensing
  154. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  155.  
  156. 1. Is Waffle free ?
  157.  
  158.         In a word, no.
  159.  
  160.         The DOS version is shareware that is made available in
  161.         binary form at many locations so you can `try before you buy'.
  162.  
  163.         The UNIX version is available as source code only, and there
  164.         is no provision to `try before you buy'.  However, the look
  165.         and feel of the two versions are almost identical, so the DOS
  166.         version serves as a `try' version.
  167.  
  168. 2. OK, so what's it cost ?
  169.  
  170.         For non-commercial sites, DOS Waffle costs $30.00 (US) for 
  171.         binaries and $120.00 (US) for sources. The unix sources are 
  172.         $120.00 (US) for non-commercial sites.
  173.  
  174.         Contact the author, Tom Dell <dell@vox.darkside.com> for info
  175.         about purchasing Waffle, or see \waffle\docs\register.doc from
  176.         the DOS distribution for more details.
  177.  
  178.         Sending him a cheque is probably best.  Mail is seldom returned.
  179.  
  180. 3. What if I bought DOS binaries and I now want sources ?
  181.  
  182.         You pay the difference between the binary fee you've paid
  183.         already and the cost of the source code.
  184.  
  185. 4. Once I'm registered, can I upgrade to new versions for free ?
  186.  
  187.         Yes, although you might have to download a copy rather than
  188.         expecting a floppy to come in the mail.
  189.  
  190.  
  191. ------------------------------
  192.  
  193. Subject: waffle: Availability
  194. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  195.  
  196. 1. How can I get Waffle by ftp ?
  197.  
  198.         Anonymous ftp:
  199.         -------------
  200.  
  201.         Waffle (DOS version) is available via anonymous ftp from
  202.         SimTel and its various mirror sites as follows:
  203.  
  204.         oak.oakland.edu
  205.                 SimTel/msdos/waffle/waf165.zip
  206.  
  207.         wuarchive.wustl.edu                     128.252.135.4
  208.                 /mirrors/msdos/waffle/waf165.zip
  209.  
  210.         There are other SimTel mirror sites.  See the periodic postings
  211.         in comp.archives.msdos.announce and news.answers for more details.
  212.  
  213.         In addition, ftp.halcyon.com has a large waffle-related FTP area:
  214.  
  215.         ftp.halcyon.com
  216.                 /pub/waffle/waffle/waf165.zip
  217.  
  218.         halcyon mirrors (keeps a current copy of) the simtel waffle
  219.         files, the simtel offline-mail files, and the tau-ceti fx
  220.         suite.  it's your one-stop waffle ftp site.  be sure to send
  221.         mail to `ralphs' thanking him for donating the resources, and
  222.         to `hpage' for being the ongoing archivist.
  223.  
  224.  
  225. 2. What if I'm not on the Internet ?
  226.  
  227.         From the author's BBS:
  228.         ---------------------
  229.         The Dark Side of the Moon BBS      1.408.245.SPAM (7726) (Tom Dell)
  230.  
  231.         From SimTel and mirrors via mail-based-archive-servers:
  232.         ---------------------------------------------------------
  233.         A number of sites run archive-servers to give non-Internet folks
  234.         the ability to do the equivalent of ftp-by-mail.
  235.  
  236.         If you do not have FTP access to SimTel, files may be ordered by
  237.         mail from:
  238.  
  239.            Internet-style:      listserv@vm1.nodak.edu
  240.                                 listserv@vm.ecs.rpi.edu
  241.  
  242.            UUCP-style:          uunet!vm1.nodak.edu!listserv
  243.                                 uunet!vm.ecs.rpi.edu!listserv
  244.  
  245.         Send this command to the server to get its help file:
  246.                 GET PDGET HELP
  247.  
  248.         NOTE: remember that if you request items from an archive-server
  249.         via mail, that your traffic goes through every system between the
  250.         server and you, and adds such load on each system.  Be courteous.
  251.  
  252.         There are a number of periodic postings in news.answers that tell
  253.         how to get software via mail in far more detail than what is
  254.         provided here.
  255.  
  256.         From other BBS sites:
  257.         ---------------------
  258.         Via mail:
  259.                 questor.wimsey.bc.ca (Steve Pershing):
  260.                         mail with text `help' to username `MailServer'
  261.  
  262.         Available for downloading:
  263.  
  264.            THIS INFORMATION IS OLD -- IT MAY NOT BE CURRENT
  265.              (if you know of a disconnected number, PLEASE let me know)
  266.  
  267.                 The Heart of Gold BBS
  268.                 +1 814 238-9633
  269.                 300-2400/v.32/v.32bis/ZyXEL 16.8k, free download on first call
  270.                 look in /file/ibm/bbs/waf*.zip
  271.                 [The Heart of Gold will be disappearing soon; if it's after
  272.                  May 1993 don't be surprised if it's gone.  Yup, I got a job.]
  273.  
  274.                 New Life Forum
  275.                 +1 503 335-3053
  276.                 2400/v.32/v.32bis, free download on first call
  277.  
  278.                 Wafflemania Unlimited
  279.                 +1 503 335-9600
  280.                 2400/v.32/v.32bis/HST 16.8k, free download on first call
  281.  
  282.  
  283.  
  284. ------------------------------
  285.  
  286. Subject: waffle: Support mechanism
  287. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  288.  
  289. 1. How can I get questions answered ?
  290.  
  291.         First, read or skim everything in \waffle\docs.
  292.  
  293.         Then use a file-searching program to search for a few keywords
  294.         that might related to an answer.  Then try a few more.
  295.  
  296.         Running a USENET site is not difficult, but it's also not
  297.         trivial.  Running Waffle is not always immediately self-evident
  298.         either.
  299.  
  300.         The docs will help... a lot.  Yes, there is a lot to read, and
  301.         yes, it seems ponderous, but most of your questions are
  302.         answered either in the docs or in this FAQ.
  303.  
  304.         Use of a version of `grep' to scan all the documents for
  305.         keywords is highly recommended, or looking in 1.65's new
  306.         \waffle\docs\index.
  307.  
  308. 2. Is there a USENET newsgroup for Waffle ?
  309.  
  310.         Yes, comp.bbs.waffle (also known as `c.b.w'.)
  311.  
  312.         Don't be shy, there's a lot of expertise in c.b.w.  That's what
  313.         it's there for.  However, be sure that you have looked through
  314.         all the documentation before posting your question; you will
  315.         not be appreciated if you ask a question that is clearly
  316.         answered in the documentation (or in the FAQ, for that matter.)
  317.  
  318. 3. Can I get in touch with the author of Waffle ?
  319.  
  320.         Yes.  [Updated answer:  unless you have a cheque, no]
  321.  
  322.         Tom Dell reads comp.bbs.waffle, though he doesn't generally
  323.         post too often since he's quite busy.
  324.  
  325.         He's also reachable via e-mail at dell@vox.darkside.com.
  326.         Be aware that Tom gets *LOTS* of mail, so replies usually
  327.         take a while.  [lately, an eternity]
  328.  
  329.         In general, normal questions to comp.bbs.waffle will get quite
  330.         a few responses in a very timely manner.  There probably aren't
  331.         too many questions you can't get answered in c.b.w.
  332.  
  333. 4. How many Waffle sites are there currently?
  334.  
  335.         It's hard to say since there are sites that are unregistered,
  336.         not in the UUCP maps, and/or are mail-only and do not exchange
  337.         news.
  338.  
  339.         Occasionally, someone counts how many Waffle sites have posted
  340.         to USENET in the past 2 weeks.  Bill Fenner, and now Alan Brown:
  341.  
  342.                 921029 930116 930216 930416 940816 941126
  343.         1.61:        2      1      2      1      0      0
  344.         1.63:        9      8      9      5      0      0
  345.         1.64:       81     44     57     46     18     14
  346.         1.65:      266    266    280    286    240    274
  347.         1.66:        0      0      0      0      0      1
  348.                    ---    ---    ---    ---    ---    ---
  349.                    358    320    348    339    258    289
  350.  
  351.         (you can't trust the version numbers -- due to these numbers
  352.         being posted, a few people have put out fake w166w headers...)
  353.  
  354.         the numbers now watch for other waffle-specific newsreaders,
  355.         so the `waffle' numbers are lower than the actual number of
  356.         waffle sites.
  357.  
  358.  
  359. ------------------------------
  360.  
  361. Subject: waffle: Mail
  362. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  363.  
  364. 1. How can I route domainized mail for my uucp neighbor directly to them ?
  365.  
  366.         Domain-based mail goes to your smarthost (as defined in static)
  367.         unless you override that route with an entry in paths.
  368.  
  369.         If you mail to `friend@hostname.domain' and you're directly
  370.         connected to them via UUCP, you can force a direct delivery
  371.         with a /waffle/uucp/paths entry of :
  372.  
  373.                 hostname.domain         hostname
  374.  
  375. 2. What should I do with my headers?
  376.  
  377.         Not a lot unless you know what you're doing.
  378.  
  379.         In general, you want your `netmail' and `netnews' parameters in
  380.         static to result in valid headers, so that people can reply to you.
  381.  
  382.         If you can do so, get into a domain and domainize all your headers.
  383.         It'll make your life easier and will do the same for people who
  384.         exchange mail with you.
  385.  
  386.         The important thing to remember is that if you put a domain-style
  387.         address out without being domainized, people will probably not be
  388.         able to reply to your mail.  Just because an address looks good
  389.         doesn't make it valid.  Most notably, `user@onesite.twosite.uucp'
  390.         is invalid.
  391.  
  392. 3. I'm not in a domain.  What should my headers look like ?
  393.  
  394.         The work you put into getting a real domain address may easily be
  395.         less than the work you put into trying to figure out why people
  396.         from mismanaged or poorly-equipped sites can't reach you.
  397.  
  398.         In general, you want to have an address that is a known-good route
  399.         from a known site.
  400.  
  401.         Some possibilities are:
  402.  
  403.                 All bang-path ===> some_known_host!your_site!you
  404.                         (i.e. mailfrom: psuvax1!%u!%A
  405.                            or mailfrom: psuvax1!%n!%A)
  406.  
  407.                 mixed format  ===> you%your_site.uucp@some_internet_site
  408.                         (i.e. mailfrom: %A%%%n@psuvax1.cs.psu.edu)
  409.                                    your_site!you@some_internet_site
  410.                         (i.e. mailfrom: %u!%A@psuvax1.cs.psu.edu
  411.                            or mailfrom: %n!%A@psuvax1.cs.psu.edu)
  412.  
  413.         (All of the examples above assume something like:
  414.                 node: hogbbs.UUCP
  415.                 uucpname: hogbbs
  416.          in your static file)
  417.  
  418.         The actual format that works best for you depends on who you're
  419.         connected to and what their mailer can handle.
  420.  
  421.         Note that the all bang-path format is not recommended for news;
  422.         sites running B News will mangle your article in such a way that
  423.         downstream sites running newer software will drop it on the floor.
  424.  
  425. 4. I'm a single-user site. Should I register in the UUCP maps?
  426.  
  427.         Yes, or get a domain name.  (FQDN==fully qualified domain name)
  428.  
  429.         The bottom line is that if people try to mail to you, you want
  430.         your address to be reachable.  From Internet, you want to get
  431.         domainized and get a MX record if you can.
  432.  
  433.         From UUCP-only sites that don't touch Internet and don't care
  434.         enough about mail reliability to get a domain name, you need at
  435.         least a map entry (or a header that routes you through somebody
  436.         with a map entry you can trust).
  437.  
  438.         Also, you shouldn't put anything in your Path: header between
  439.         the `!'s other than a FQDN or your _registered_ uucp name.  if
  440.         you like the name `foo' but don't register it, don't send out
  441.         news that says:
  442.  
  443.           `Path: foo!user'
  444.  
  445.         since the person who actually did the _right_ thing and registered
  446.         foo won't ever see your news -- and neither will the sites beyond
  447.         that site, probably.  What you _should_ have in this case is
  448.  
  449.           `Path: foo.some.org!user'
  450.  
  451.         by setting the `newsname' parameter in the STATIC file.
  452.  
  453.  
  454.         not to MENTION mail getting mixed up.
  455.  
  456. 5. Can I display something other than the sender when listing mail ?
  457.  
  458.         Yes, as of 1.65 you can specify the header you want to see when
  459.         you do a list of messages via the `listmail' item in static.
  460.         Unfortunately, this is not configurable per-user, only per-site.
  461.  
  462. 6. Does Waffle support mail folders ?
  463.  
  464.         Yes, as of 1.65.
  465.  
  466.         If you have no new mail in your mailbox, you can say `mail *' to
  467.         get a list of mailboxes to read.
  468.  
  469. 7. Can I use (my favorite mail program) ?
  470.  
  471.         Some people have had luck with `readmail' for reading only,
  472.         and at 1.65 either mush or pc-elm should work for read/write.
  473.  
  474.         Version 1.65 has MMDF-style mailboxes with messages separated
  475.         by four control-A's, so mush and pc-elm should be able to
  476.         read/write these messages, though you'll have to reindex your
  477.         mailbox with `makebox' or the like if you write to it.
  478.  
  479. 8. Can I keep a record of all mail that comes into the system ?
  480.  
  481.         Yes, create a file called `inbox' in \waffle\admin and all
  482.         incoming mail will be copied there. You can stash this file
  483.         elsewhere via the rr.inbox variable in the static file.
  484.         See rmail.doc for more information...
  485.  
  486. 9. Can I get FidoNet Netmail on my Waffle?
  487.  
  488.         See question 12 under NEWS, for information about Erin/Amanda.
  489.  
  490.  
  491. ------------------------------
  492.  
  493. Subject: waffle: Files section
  494. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  495.  
  496. 1. How can I set the prompt in the files section ?
  497.  
  498.         Use the `fileprom' static file parameter.  Try `fileprom : [$f] :'
  499.         as an example.  (it was undocumented before v1.65)
  500.  
  501. 2. I use a Fossil driver and a 16550 UART with FIFOs enabled. After
  502.      someone transfers a file, why does it seem as if characters are not
  503.      being transmitted?
  504.  
  505.         If you use DSZ, it directly accesses the UART, and uses the
  506.         FIFOs.  By default, it turns them OFF when it finishes. Since
  507.         Waffle doesn't reset the Fossil driver, it tries stuffing
  508.         characters into a buffer that's turned off.
  509.  
  510.         The fix is to use the `F' flag on DSZ's command line in
  511.         \waffle\extern\_send and _receive:
  512.  
  513.         Z /command="C:\waffle\bin\dsz F port %d est 0 %b sz -m %i",
  514.  
  515.         or to use the new (as of 1.65) /reset flag on the extern to 
  516.         make Waffle reset the FOSSIL:
  517.  
  518.         Z /command="C:\waffle\bin\dsz port %d est 0 %b sz -m %i" /reset
  519.  
  520.         This can also affect file transfers using the built-in
  521.         editor.
  522.  
  523. 3. People with priv 9 can access the file section fine, but people with
  524.     normal access get `Validation is required to use the FILES section.'
  525.  
  526.         Check your /waffle/system/dirs file.  This error occurs if
  527.         the user does not have access to the root file directory
  528.         (`files:' in the static file).  A sample from hogbbs's (working)
  529.         configuration:
  530.  
  531.         /waffle/system/static:
  532.  
  533.                 files: f:/file
  534.  
  535.         /waffle/system/dirs:
  536.  
  537.                 1 /dir="f:/file" /access=1
  538.  
  539.  
  540. ------------------------------
  541.  
  542. Subject: waffle: Externals
  543. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  544.  
  545. 1. How do they all work ?
  546.  
  547.         Simple.  There's \waffle\extern\_system for the normal
  548.         commands, and you can add any command you want with any access
  549.         you want by adding a corresponding file to the \waffle\extern
  550.         directory.  The file that you create corresponds to the name of
  551.         the new command.  Be very careful regarding security, though,
  552.         as externs can be the least secure part of Waffle.
  553.  
  554. 2. I use 4DOS, yet Waffle shells out to DOS, not 4DOS...
  555.  
  556.         You need to change the command interpreter in \waffle\extern\_system
  557.         to use 4DOS rather than command.com
  558.  
  559. 3. If I implement Waffle as a door from another BBS, how can users exit
  560.     from Waffle without dropping carrier?
  561.  
  562.         First, disable the `exit' command in Waffle by adding the
  563.         following line to your static file.
  564.  
  565.         disable: exit
  566.  
  567.         Then provide an external implementation of the exit command by
  568.         creating extern\exit with the following contents.
  569.  
  570.         /access=0 /logout=exit /log /exit=81
  571.  
  572.         This causes Waffle to exit, without dropping the modem connection,
  573.         with errorlevel 81 (or whatever level you want to specify).  The
  574.         /access=0 ensures that all Waffle users can get back out once they
  575.         get in.  Then you just trap errorlevel 81 in the batch file that
  576.         started Waffle to go back to the other BBS.
  577.  
  578.  
  579. ------------------------------
  580.  
  581. Subject: waffle: Editors
  582. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  583.  
  584. 1. What editors can I use ?
  585.  
  586.         Locally, any editor your little 'ol heart desires that works
  587.         in pure ASCII (ie, you could use WordPerfectOffice, but not
  588.         WordPerfect itself since that saves in a non-ASCII format normally).
  589.  
  590.         Remotely, you have to be careful to use an editor that is ANSI
  591.         oriented and that doesn't do direct DOS screen I/O. Some editors
  592.         that are frequently used (and are available on SimTel and other
  593.         fine archive sites) include:
  594.  
  595.                 MEANSI     - MicroEmacs compiled to use ANSI mode.
  596.                 BBStevie   - vi clone
  597.                 FSED       - a very configurable editor that can be made to
  598.                                 look like just about any editor you want
  599.                 WWIVEDIT   - the editor for WWIV
  600.  
  601.         Be aware that if you set up external editors for your remote users,
  602.         you might have a security risk on your hands.  Be sure that you
  603.         know whether your editor will let a remote user shell out to the
  604.         operating system or not, and that you're giving exactly the
  605.         privileges you mean to give out.
  606.  
  607.         BBStevie in particular is designed to be configurable so that you
  608.         can prevent folks from getting to the shell (if you want) and you
  609.         can use the same binary to ALLOW some other folks shell access if
  610.         you want to do that, based on their Waffle access level.  BBStevie
  611.         will also only let users mess with files in their home directory.
  612.  
  613. 2. How can I use different local and remote editors ?
  614.  
  615.         At 1.65, you can define different local and remote editors from
  616.         within Waffle, so it's simple.  The STATUS command does not let
  617.         you edit your local editor, however; you have to ADMIN T <you>.
  618.  
  619.         Prior to 1.65, you should modify /waffle/extern/_editors to run
  620.         a batch file which gets passed the baud rate, and decides based
  621.         on that whether to run a local or remote editor.
  622.  
  623. 3. Why does (insert editor here) work locally, but not remotely?
  624.  
  625.         If you try BBStevie locally and it's fine, yet you get a blank
  626.         screen when you use it remotely, make sure that you do not have
  627.         an ansi driver loaded.  Some people have luck using PC Magazine's
  628.         ansi.com, which can be loaded and unloaded as part of a batch file
  629.         around your `waffle local username' command, so that there's no
  630.         ansi driver loaded by default for remote users.
  631.  
  632.         Version 3.0 of BBStevie can use a FOSSIL driver to do its own 
  633.         modem i/o, so that you can use a local ANSI driver to handle 
  634.         local use and remote use will take care of itself.
  635.  
  636. 4. How come STATUS / EDITOR still says there are no editors on the system,
  637.     when I just added stuff to /waffle/extern/_edit?
  638.  
  639.         You need to manually edit /waffle/menus/editors to reflect the
  640.         editors that are available on your system.  Make sure to include
  641.         that the user can select `none' to get back to the internal editor.
  642.  
  643.  
  644. ------------------------------
  645.  
  646. Subject: waffle: News
  647. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  648.  
  649. 1. Can I keep a copy of all posts ?
  650.  
  651.         Yes, look in static.doc and the USENET file distributed
  652.         with Waffle for /spy=monitor.  basically just have
  653.         `DEFAULT /spy=monitor' at the top of your waffle/system/usenet
  654.         file, and you'll probably be ok (unless you drastically
  655.         changed your `forums' static file entry).
  656.  
  657. 2. Can I gateway mail to news ?
  658.  
  659.         Absolutely.  You need to set up an alias in `aliases' that
  660.         looks something like the following:
  661.  
  662.         newsgroup-name  | post newsgroup.name
  663.  
  664.         To go the other way, add
  665.  
  666.         newsgroup.name /mod="submission-address-of-mailing-list".
  667.  
  668.         For example, I have the Pink Floyd mailing list gatewayed on
  669.         hogbbs to mail.echoes .  I got the list maintainer to send
  670.         the mailint list to echoes-list@hogbbs.scol.pa.us, and have
  671.         the following entry in `aliases':
  672.  
  673.         echoes-list  | post mail.echoes
  674.  
  675.         My definition for mail.echoes in my USENET file looks like:
  676.  
  677.         mail.echoes /name="The Pink Floyd Mailing List"
  678.                     /mod=echoes@fawnya.tcs.com
  679.  
  680.         (That should all be on one line; it was split for inclusion
  681.         in the FAQ.)
  682.  
  683. 3. Does Waffle provided threaded newsreading ?
  684.  
  685.         Not at this time.  See the section on Aftermarket add-ons
  686.         for info on external newsreaders which do provide threaded
  687.         newsreading.
  688.  
  689. 4. Does Waffle support kill files ?
  690.  
  691.         Not at this time.  Meanwhile, check the section on Aftermarket
  692.         add-ons, as above.
  693.  
  694. 5. Why do I see multiple copies of the same article ?
  695.  
  696.         Because Waffle has no `real-news'-like history mechanism
  697.         at this time.  Waffle considers an article to be a duplicate
  698.         only if the local site is already in the path.  Even then, it
  699.         gets it wrong (substrings match where they shouldn't).
  700.  
  701.         If you get a newsfeed of the same newsgroup from several Waffle
  702.         sites into your DOS Waffle, expect to see lots of duplicates :-(
  703.  
  704.         History mechanism is currently planned (rumored) for v1.66.  It
  705.         is available now through Waffle C News (on halcyon).
  706.  
  707.         Also, if you read two groups, and a message is crossposted to
  708.         both groups, the builtin newsreaders will show it to you twice.
  709.  
  710.         There are several third-party solutions - see the section on
  711.         Aftermarket add-ons.
  712.  
  713. 6. Why do my local postings not make it to USENET ?
  714.  
  715.         Check your /waffle/system/feeds file.  Is there an entry for
  716.         your feed there, saying to send all newsgroups there?  If you
  717.         have a /batch= flag in that feeds entry, did you forget to run
  718.         the `batch' command to take the list of articles to go out,
  719.         assemble them, compress them, and queue them up for
  720.         transmission.
  721.  
  722.         You should call `batch' from your poll.bat or from cron via the
  723.         schedule file.
  724.  
  725.         a simple `feeds' file for a leaf that connects to othersite is:
  726.  
  727.             othersite /batch=compress *
  728.  
  729. 7. Can I edit the newsgroups line when making a post ?
  730.  
  731.         Not directly, but you can `followup groupA groupB' and get
  732.         the same functionality.  Same goes for mailing a reply to
  733.         somebody and also kicking your reply to somebody else.
  734.  
  735.         also, check some of the third-party readers
  736.  
  737. 8. Can I effectively read and followup to saved news messages ?
  738.  
  739.         Not really at this time.  If you're at the console, you could use
  740.         `readmail' to read them reasonably efficiently, though you
  741.         couldn't respond via mail or followup.  (this may change with
  742.         the new, reply-capable version of readmail)
  743.  
  744.         There are also a myriad of relatively ugly workarounds available
  745.         in 1.65 making creative use of makebox.exe, perl, etc. to make the 
  746.         saved messages into a mail folder.
  747.  
  748.         Being able to have saved news articles as a mail `folder' and
  749.         use the mail program to read/follow/reply to saved news has
  750.         been suggested to Tom for a future release.
  751.  
  752. 9. In `rn', how can I mail an article to somebody other than the author?
  753.  
  754.         Hit `:m username'
  755.  
  756.         Same idea for saving a message to a specified filename. In that
  757.         case you want to hit `:s filename'.
  758.  
  759.         Think of it like hitting `:' to get to command mode in vi.  
  760.  
  761.         Be careful, though, if you're at a `More' prompt - at the `More'
  762.         prompt, a `:' just gets you to the `What next?' prompt, so you
  763.         have to hit two colons.
  764.  
  765. 10. I get `write/text: No such file or directory, D:\NEWS/monitor/1'
  766.     when posting a message.
  767.  
  768.         You must create the monitor newsgroup manually.  monitor and
  769.         local newsgroups are the only ones that must be created manually;
  770.         rnews will create directories for groups in your FORUMS file
  771.         as needed.
  772.  
  773.         this is _not_ a `/' vs. `\' problem.
  774.  
  775.         people who write third-party newsreaders:  please have your
  776.         package create the directory, and save grief all around.  thanks.
  777.  
  778. 11. My users want to use their QWK offline reader to read their netnews.
  779.     Does Waffle support this?
  780.  
  781.         (make sure they don't try to reply using QWK packets, since
  782.         without a lot of playing around and lying to software, it just
  783.         won't work incredibly well, if at all.)
  784.  
  785.         There is a .QWK door for Waffle, called WafLineMail, which was
  786.         written for 1.64 .  It will sort-of work with 1.65 if you use
  787.         the `explode' utility to unpack your 1.65 mailbox; it works OK
  788.         with news in 1.65 still.  Unfortunately, WafLineMail 1.0 is the
  789.         sort of program that works perfectly on some machines and
  790.         doesn't work at all on others and nobody can ever figure out
  791.         why.
  792.  
  793.         There is a beta of WafLineMail 2.0 floating around, which knows
  794.         about 1.65's mailbox format, and may or may not be more reliable.
  795.  
  796.         WafLineMail 1.0r is available as `wafm10.zip', and the beta that
  797.         I saw was on ftp.halcyon.com:/pub/waffle/wlmb5.zip .
  798.  
  799.         As far as I know, development work on WafLineMail has been dropped.
  800.  
  801.         If you want your messages to not have their headers stripped to fit
  802.         inside the old QWK format, look in the group alt.usenet.offline-reader
  803.         to see what software there is available.  both solar and zipnews
  804.         are available as packers for waffle sites, and a handful of
  805.         packages for various machines handle reading/writing their formats.
  806.         solar uses the SOUP (formerly HDPF/HPF/SLNP) format, while zipnews
  807.         has its own, slightly different, format.
  808.  
  809.         for contact information and software ftp locations, please see the
  810.         comp.os.msdos.mail-news FAQs.
  811.  
  812.  
  813. 12. Can I get FidoNet echoes on my Waffle BBS?
  814.  
  815.         There is one package, Amanda, written by David Douthitt
  816.         (rat@ruth.fullfeed.com) to process Fidonet news packets
  817.         for MSDOS Waffle v1.65.  Amanda is on simtel.
  818.  
  819.         There is another package, Erin, written also by David Douthitt,
  820.         which will handle Fidonet mail packets for MSDOS Waffle v1.65.
  821.         However, this package is not yet released.  Information on Erin
  822.         will be released through the amanda-l mailing list as it
  823.         becomes available, and will be available there first.
  824.  
  825.         Both Amanda and Erin require MSDOS Waffle v1.65 (complete), and
  826.         a Fidonet mailer such as FrontDoor or BinkleyTerm.
  827.  
  828.  
  829.  
  830. 13. What hosts should I put in my `backbone:' static file entry?
  831.  
  832.         The sites currently maintaining these lists are given in the
  833.         following list.  Pick the one that is `closest' to your site
  834.         and use it in your `backbone' format string:
  835.  
  836.     ames.arc.nasa.gov       beaver.cs.washington.edu  cis.ohio-state.edu
  837.     decuac.dec.com          decwrl.dec.com          eddie.mit.edu
  838.     kddlab.kddlabs.co.jp    linus.b.mitre.org       math.waterloo.edu
  839.     mcnc.org                ncar.ucar.edu           rutgers.edu
  840.     tektronix.tek.com       ucbvax.berkeley.edu     ucsd.edu
  841.     uflorida.cis.ufl.edu    uunet.uu.net            wrdis01.af.mil
  842.  
  843.  
  844. ------------------------------
  845.  
  846. Subject: waffle: Administering a usenet site
  847. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  848.  
  849. 1. What books should I buy ?
  850.  
  851.         There are several that no USENET admin with a book fetish should
  852.         be without.
  853.  
  854.         From O' Reilly and Associates:
  855.  
  856.                 Administering UUCP and USENET
  857.                 - widely recommended, Unix-based, might be helpful
  858.  
  859.                 A Directory of Electronic Mail Addressing and Networks
  860.                 - possibly interesting if you're doing weird mail
  861.                   things, but not a uucp-specific book by any means
  862.  
  863.         From `The Waite Group'
  864.                 Unix Communications
  865.                 - obviously, Unix-based.  can't find my copy right now.
  866.  
  867. 2. What other stuff should I read ?
  868.  
  869.         Read USENET news, particularly some or all of the following
  870.         groups:
  871.                 comp.bbs.waffle
  872.                 comp.mail.uucp
  873.                 news.admin.misc
  874.                 news.answers
  875.                 news.newusers.questions
  876.  
  877.         There is a FAQ posted to news.admin.misc, news.announce.newusers,
  878.         and news.answers called `How to become a USENET site', which
  879.         includes lots of useful information about finding your initial
  880.         connection.
  881.  
  882.  
  883. ------------------------------
  884.  
  885. Subject: waffle: Communications
  886. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  887.  
  888. 1. What settings do I use for my Telebit modem ?
  889.  
  890.         That's far too complicated a question to answer here.
  891.         In general, turn compression off, and turn uucp `spoofing' on.
  892.  
  893.         This can all be done on the fly by sending register settings as
  894.         part of your send-expect sequence when you call out, or you can
  895.         do so as part of your modem initialization string in static.
  896.  
  897.         Some Telebit modems don't save the register settings.  You might
  898.         have to set the registers in both the init string and in the
  899.         calling sequence.
  900.  
  901.         Also, grab a FOSSIL driver to control the port if you are
  902.         running a 9600 baud modem or above.  BNU and X00 seem to be the
  903.         most popularly used fossils according to the folks in c.b.w.
  904.         Don't forget to set the driver to `fossil' in the static file.
  905.  
  906.         Remember: there is a `trailblazer-faq' posted to news.answers
  907.  
  908. 2. What's the best throughput I can expect ?
  909.  
  910.         Throughput is a function of a variety of things, including
  911.         (but not limited to):
  912.                 - the speed and load of both systems
  913.                 - the speed of both modems
  914.                 - line noise on the phone line
  915.                 - the size of the batches being transferred
  916.                 - whether or not you are using a FOSSIL driver
  917.                 - which UUCICO engine you use
  918.  
  919.         With a 2400 baud modem, you should get anywhere between 200 and
  920.         220 cps unless you're transferring very small batches.
  921.  
  922.         V.32 (9600 bps) should get anywhere between 700 and 1020 cps.  
  923.  
  924.         With a Telebit Trailblazer Plus, you should expect something on
  925.         the order of 800 to 1400+ characters/second to a similar modem.
  926.  
  927.         Watch your \waffle\admin\net file for details regarding your
  928.         average characters per second.  A drop off from what's `normal'
  929.         could indicate hardware problems or line problems.
  930.  
  931.         To summarize your DOS net file easily, grab a copy of `netsum' from
  932.         the Waffle directory on one of the archive sites..
  933.  
  934.         It can generate a variety of reports that can answer things like
  935.         `based on 11 cents/minute, how much DID I spend to uunet so far ?'
  936.  
  937. 3. What are the special characters recognized by the chat script ?
  938.  
  939.         See \waffle\docs\network.doc or `Managing UUCP and USENET'
  940.         for details.
  941.  
  942. 4. How can I stop my connection from timing out while switching speeds ?
  943.  
  944.         Use uu.time in static to set a default delay or use the -t
  945.         parameter in your uucico command to override the default.
  946.         See network.doc for more details.
  947.  
  948.         Also, make sure your modem will wait for a carrier at least as
  949.         long as the uu.time you specify.  If your modem uses the AT
  950.         command set this is probably the S7 register setting.
  951.  
  952.         Lastly, if you talk to a Telebit modem and you have a
  953.         non-Telebit modem (that talks just fine to anything else), you
  954.         might want to ask your feed to put PEP tones last.  Initial PEP
  955.         tones can confuse non-Telebit modems quite a bit.
  956.  
  957. 5. What does this error mean?
  958.  
  959.         See \waffle\docs\network.doc, `Managing UUCP and USENET', or
  960.         Ian Taylor's UUCP Internals FAQ, posted to news.answers, for
  961.         details.
  962.  
  963. 6. I have a high speed modem.  After saying [Connect 14400], Waffle complains
  964.    [14400 unsupported]!  Why can't Waffle handle high speed connections?
  965.  
  966.         Just bump the speed to 19200, a `standard' serial speed.
  967.  
  968.         You have locked your FOSSIL, without telling Waffle about it.
  969.         This is a no-no.  Put `locked: xxxx' in your static file, and
  970.         Waffle will shut up about `unsupported'.  It actually doesn't
  971.         matter what speed you use in the locked: parameter, if you have
  972.         locked using the FOSSIL.
  973.  
  974. 7. Waffle keeps saying `[ Echo should't be on - waaah! ]' when initializing
  975.    the modem.
  976.  
  977.         This message is basically harmless and can be safely ignored.
  978.  
  979.         For Waffle to not complain about this, echo must be in a
  980.         consistent state - either always on, or always off.  If you
  981.         want it to be always off, put E0 in your default profile.  If
  982.         you want it to be always on, put E1 in your default profile,
  983.         and E1 (MUST be uppercase, `e1' won't cut it) in your init:
  984.         static file entry.
  985.  
  986.         Note that if you occasionally get the error message, then
  987.         you're probably starting up Waffle after having echo on (in
  988.         your terminal program, for example), and not resetting your
  989.         modem.
  990.  
  991.  
  992. ------------------------------
  993.  
  994. Subject: waffle: Aftermarket add-ons
  995. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  996.  
  997. 1. What add-on products are available for Waffle ?
  998.  
  999.         Lots...and I mean lots.
  1000.  
  1001.         When in doubt poke around the Waffle directory on SimTel or a
  1002.         mirror site for the list of stuff that's purely Waffle related.
  1003.  
  1004.         Also, keep your eyes open in the Waffle newsgroup for information
  1005.         related to utilities that might not have been uploaded to Simtel.
  1006.  
  1007.         ftp.halcyon.com, on the Internet, has a huge anonymous ftp
  1008.         section, in /pub/waffle, which was (but is no longer) mirrored
  1009.         by remote.halcyon.com for anonymous UUCP.  There is an anonymous
  1010.         UUCP list posted frequently to c.b.w -- see later.
  1011.  
  1012.         Also, grep for `waffle' in the comp.os.msdos.mail-news FAQ.
  1013.  
  1014.         Lastly, look in \waffle\docs\third.doc in 1.65
  1015.  
  1016. 2. I don't like Waffle's user interface.  Is there another program that
  1017.     I can use to access news?
  1018.  
  1019.         Current ftp locations and author addresses, as well as a
  1020.         complete list of known packages, should be obtained from the
  1021.         comp.os.msdos.mail-news FAQ.
  1022.  
  1023.         There are about 20 waffle-compatible newsreaders listed there.
  1024.  
  1025.         Any of the MS-DOS readers should be easy to hook into Waffle
  1026.         1.65's Chrome hook - in RUN.BAT, instead of running CHROME,
  1027.         run the reader that you like.  Under 1.64, if you don't find
  1028.         yourself using `p' to poll often, you could put it there.
  1029.  
  1030. 3. I don't like Waffle's user interface.  Is there another program that
  1031.     I can use to access the files section?
  1032.  
  1033.         Harrison Page, one of the few people who knows Tom Dell personally
  1034.         and posts trivia updates to c.b.w, has written a replacement files
  1035.         section called `unfiles'.  mail at harrison@hedgehog.darkside.com
  1036.  
  1037. 4. Duplicate message killers
  1038.  
  1039.         checkdup - by russell@alpha3.ersys.edmonton.ab.ca (Russell Schulz)
  1040.         Must be run in each newsgroup directory seperately -- good if
  1041.         you're only getting a few groups duplicated.  limits of 4000
  1042.         articles/group, and 80 chars in a Message-ID: header.  you must
  1043.         use a unix-like find (such as `stuff') to handle many groups.
  1044.  
  1045.         nscu11 - by chorn@eastwind.mcds.com (Christopher Horn)
  1046.         Runs through whole directory tree, good if you get lots of
  1047.         dupes.  Also resequences articles, so that your users don't get
  1048.         to see weird article number jumps.  NSCU compares CRC's and not
  1049.         full Message-ID's, so should be faster than the others.
  1050.  
  1051.         dupweed - by kjhoule@iowegia.uucp (Kevin Houle)
  1052.         Provides approximately the same functionality as nscu, but
  1053.         compares full Message-ID strings.  Limited to 750 articles per
  1054.         newsgroup, and 40 subdirectories per directory.
  1055.  
  1056.         history - by dawson@(?) (Willard Dawson)
  1057.         (?)
  1058.  
  1059. 5. alternate UUCICO transfer engines
  1060.  
  1061.         fxuucico - by jorge@satlink.net (and probably *@uufx.net...)
  1062.         since no waffle version of uucico (including 1.65) can prevent
  1063.         a determined person on the other end from reading files you
  1064.         didn't allow them to, and this one does, it seems worth the
  1065.         cash for any but the most trusting sites.  unfortunately, it
  1066.         does not work with 1.64-compatible config files.  it does work
  1067.         with a variety of config files, including 1.65-compatible ones.
  1068.         maybe with some messing about, it will work with 1.64 as well...
  1069.  
  1070.         uupcwaf - long ago, someone posted patches to uupc's uucico
  1071.         which handled waffle-style filename munging instead of uupc-style.
  1072.         I probably have them around here somewhere...
  1073.  
  1074. ------------------------------
  1075.  
  1076. Subject: waffle: Miscellaneous
  1077. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  1078.  
  1079. 1. How can I set my mail and news signatures to be different ?
  1080.  
  1081.         It's built-in already.
  1082.         The mailsig file is for mail, the sig file is for news.
  1083.  
  1084.         The \waffle\system\sig file gets inserted if it's there and you
  1085.         don't have a personal sig or mailsig file.
  1086.  
  1087.         If you want to be able to pick which sig goes on which message,
  1088.         try Roy Silvernail's APPSIG.ZIP .
  1089.  
  1090. 2. Why doesn't /waffle/system/mailsig work?
  1091.  
  1092.         The different names are only for the user's personal signature.
  1093.         If you have a system default signature, /waffle/system/sig, it
  1094.         is applied to *all* messages.
  1095.  
  1096. 3. Can I use 16-bit compression ?
  1097.  
  1098.         Sure, if you have enough memory and can find a 16-bit compression
  1099.         program.
  1100.  
  1101.         One is provided with 1.65 and there are a variety of add-in
  1102.         16-bit compress programs for 1.64 and earlier available on SimTel.
  1103.  
  1104.         If you use 16-bit compress, be sure you have the `compress' flag
  1105.         in the static file set correctly for the compress you're using.
  1106.         See \waffle\docs\comp16.doc .
  1107.  
  1108. 4. What are all those files in \waffle\* anyway ?
  1109.  
  1110.         See \waffle\docs\roadmap.doc for descriptions of almost every
  1111.         file that comes with the software.
  1112.  
  1113. 5. What document in \waffle\docs contains what ?
  1114.  
  1115.         \waffle\docs\index.doc has the table of contents of each of
  1116.         the other documents.  Use a text editor or something similar
  1117.         to look for keywords in index.doc, then it will point you to
  1118.         which file to look in.
  1119.  
  1120.         If you have a version of the UNIX utility `grep', it's best
  1121.         to do something like `grep keyword \waffle\docs\*', to find
  1122.         even obscure references to things.
  1123.  
  1124.         You'll find a lot of neat but obscure references in HISTORY.DOC.
  1125.  
  1126. 6. Can I alter my headers after composing a message ?
  1127.  
  1128.         Some of them are editable in 1.65 via the `alter' static parameter.
  1129.         Don't put `To:', `CC:' or `Newsgroups:' in `alter'; it won't work.
  1130.  
  1131.         Of course, third-party packages tend to not have these restrictions.
  1132.  
  1133. 7. Does DOS Waffle support control messages ?
  1134.  
  1135.         Other than cancelling a message you posted that hasn't been
  1136.         batched up yet, no.  You might want to look at the contents of
  1137.         the control newsgroup once in a while to see what control
  1138.         messages you received that Waffle didn't process.
  1139.  
  1140.         There's a program called procc, `PROCess Control' which will
  1141.         handle control messages for you.  Look for procc-NN.zip where
  1142.         NN is the version number.
  1143.  
  1144.         There's also wafctl, Waffle Control, which does more than procc.
  1145.         It will create files for nwreader to use to present users with
  1146.         notices of new groups when the control messages come in.
  1147.  
  1148. 8. What does this `Splash file before login' flag do?  I can't find it in
  1149.    the docs.
  1150.  
  1151.         If a user logs in with the `Splash file before login' flag, and
  1152.         a file exists in /waffle/text named after that user, it will be
  1153.         displayed (`splashed') immediately after the user enters their
  1154.         password correctly.  Example: user falken has `Splash file ...'
  1155.         set in his profile:
  1156.  
  1157.         hogbbs!login: falken
  1158.         Password: 
  1159.  
  1160.         [this is /waffle/text/falken]
  1161.         (>
  1162.  
  1163.         Greetings, Professor Falken.  Would you like to play a game?
  1164.  
  1165.         [this is /waffle/text/welcome, which everyone sees]
  1166.         Welcome to the Heart of Gold
  1167.         ...
  1168.  
  1169.  
  1170. ------------------------------
  1171.  
  1172. Subject: waffle: Waffle bugs
  1173. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  1174.  
  1175. As with any large system, Waffle has bugs.  Since the source is available,
  1176. some users have fixed some of the bugs that have cropped up.  In this
  1177. section, the notation `Patch: <user>' means that the mentioned user has
  1178. a patch to the source code available that will fix the problem.  You need
  1179. to already have the source code for this to be useful to you.  `BPatch: <user>'
  1180. means that the mentioned user has a binary patch available, which anyone
  1181. should be able to use.  `Fixed: 1.xx' means that the bug is fixed as of
  1182. the mentioned version.  `Workaround:' means that there is a way to avoid
  1183. the bug in normal operation.
  1184.  
  1185. 1. When I mail to a | post alias from within Waffle, it only posts the headers.
  1186.  
  1187.         This is a bug having to do with external editors.
  1188.         Workaround: use the internal editor when mailing to such an alias.
  1189.         Patch: fenner@cs.psu.edu
  1190.         Fixed: 1.66
  1191.  
  1192. 2. When I mail to a | post alias from within Waffle, it only works the first
  1193.         time, the second time it doesn't do *anything*.
  1194.  
  1195.         Workaround: none known.
  1196.         Patch: fenner@cs.psu.edu
  1197.         Fixed: 1.66
  1198.  
  1199. 3. I configured my modem to work with FAX, but Waffle keeps saying
  1200.     [Hayes code -2] and hangs up.
  1201.  
  1202.         This occurs if you have Auto-ATA: in your static file.
  1203.         Workaround: make your modem answer the phone (no Auto-ATA: in the
  1204.             static file and ATS0=1 in the initialize string).
  1205.         Patch: fenner@cs.psu.edu
  1206.         Fixed: 1.66
  1207.  
  1208. 4. I have personal aliases for `mom' and `dad', and when I type `mail mom dad'
  1209.     Waffle complains `No such user', even though I can type `mail mom' or
  1210.     `mail dad' and it works fine.
  1211.  
  1212.         Waffle's implementation of personal aliases isn't complete.
  1213.         Workaround: put the aliases in /waffle/system/aliases
  1214.         WARNING: This makes your aliases available to all users, so
  1215.          *be* *careful* with what you put there.
  1216.  
  1217. 5. I have `finger_ok: 3' in my static file but anyone can use the FINGER
  1218.     command.
  1219.  
  1220.         Apparently, this check got lost somewhere; Waffle completely
  1221.             ignores the finger_ok: static variable.
  1222.         Workaround: None, save writing an extern to duplicate the
  1223.             functionality that you want, and controlling access to
  1224.             that via the extern files.
  1225.  
  1226. 6.  uux -b gives me garbage
  1227.  
  1228.         uux -b doesn't work.  try to use uux -i (if the files are on
  1229.         the same physical drive, ugh) or get a replacement uux.  one
  1230.         is ruux, hopefully on halcyon.
  1231.  
  1232. 7.  rmail messes up headers with more than one space after the `To:'
  1233.  
  1234.         it doesn't hurt delivery, just makes the headers ugly
  1235.  
  1236.  
  1237. ------------------------------
  1238.  
  1239. Subject: waffle: Transition to 1.65
  1240. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  1241.  
  1242. 1. I updated my config files, but they didn't work.
  1243.  
  1244.         Some of the config files, notably `paths', moved in 1.65 to the
  1245.         new \waffle\uucp directory.  Make sure you aren't editing the file
  1246.         in the old 1.64 location.
  1247.  
  1248. 2. I'm going to run makebox.  Anything I should know ?
  1249.  
  1250.         Yes.  Makebox deletes the old mail files after it assembles the 
  1251.         new mailbox.  If you're paranoid, you might want to zip up your 
  1252.         1.64 mail messages before running makebox if you're not sure you'll 
  1253.         stay at 1.65.
  1254.  
  1255.         If you mess up, try to find a copy of `explode.zip' (it's on
  1256.         ftp.halcyon.com in /pub/waffle/mail); it will take a 1.65 mailbox
  1257.         back to 1.64 format.
  1258.  
  1259. 3. 1.65 sure seems scary, why should I bother?
  1260.  
  1261.         Lots of reasons.  See history.doc and release.165 for details.
  1262.  
  1263.         Of course, if you're happy with the version you run, there's
  1264.         not a lot of rush to get updated, though most of the c.b.w
  1265.         readers keep at the current version and you'll get better help
  1266.         from c.b.w by staying current.  In addition, there are
  1267.         increasingly many utilities that will only work with version
  1268.         1.65 .  However, there are still some Waffle sites at v1.61,
  1269.         so obviously old versions still work)
  1270.  
  1271.  
  1272. ------------------------------
  1273.  
  1274. Subject: waffle: Waffle and OS/2
  1275. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  1276.  
  1277. ==begin FAQ caption==
  1278.   From: harrison@hedgehog.darkside.com (Harrison Page)
  1279.   Newsgroups: comp.bbs.waffle
  1280.   Subject: Re: Waffle and OS/2?
  1281.   Message-ID: <RVRZPc1w165w@hedgehog.darkside.com>
  1282.   Date: Sun, 24 Jul 94 16:46:14 PDT
  1283.  
  1284. I've had good experiences with OS/2 and Waffle, through I am not running
  1285. a bulletin board system - just a site for news, mail, and a mail-based
  1286. archive server. I use the scheduler built into a Shareware utility for
  1287. OS/2 called FILEBAR (works great) and the stock UUCICO that comes with
  1288. Waffle.
  1289.  
  1290. Here's what I've gathered from comp.bbs.waffle over the last few months:
  1291.  
  1292. tas@dadstoy.jpunix.com (Terry Stockdale) wrote:
  1293.  
  1294. > I similarly use Waffle for polling, but FXUUCICO under Waffle, and an
  1295. > external cron (cron213.zip) to handle rnews and rmail, as well as
  1296. > administrative tasks. I'm using RNF (now v.77beta9) and am very pleased
  1297. > with it.  Plus, it can keep my Waffle "join" file in sync with its
  1298. > rnfjoin file.  I've had good experience with Ray Gwinn's SIO/VSIO/VX00
  1299. > comm drivers (now sio126e.zip).
  1300.  
  1301. ka6etb@GRAFex.sbay.org (KA6ETB Steve Harding) wrote:
  1302.  
  1303. [this section deleted -- see Steve's separate entry later]
  1304. ==end FAQ caption==
  1305.  
  1306. ==begin FAQ caption==
  1307.   From: mikey@slic.cts.com (Mike Shirley)
  1308.   Newsgroups: comp.bbs.waffle
  1309.   Subject: Waffle & OS/2 Specific Mailing List; was Re: os/2 CRON
  1310.   Message-ID: <5DeZwc3w165w@slic.cts.com>
  1311.   Date: Wed, 07 Dec 94 20:50:03 -0800
  1312.  
  1313. To join the Waffle - OS/2 Mailing List, send a letter to:
  1314. server@slic.cts.com     In the body on the first two lines enter:
  1315.  
  1316. join WaffOS2-L          (Case not important)
  1317. quit
  1318. ==end FAQ caption==
  1319.  
  1320. ==begin FAQ caption==
  1321.   To:     cbwfaq@alpha3.ersys.edmonton.ab.ca (Comp.Bbs.Waffle FAQ)
  1322.   From:   ka6etb@GRAFex.sbay.org (KA6ETB Steve Harding)
  1323.   Message-ID: <gD5BZc1w165w@GRAFex.sbay.org>
  1324.   Date:   Sun, 22 Jan 1995 07:49:39 -0700
  1325.  
  1326. After doing some research, I have amended my portion of the OS/2 stuff.
  1327.  
  1328.  
  1329. Setting up Waffle in OS/2:
  1330. =========================
  1331.  
  1332. 1.      Change the shell entry in your ~/waffle/extern file to read:
  1333.  
  1334.         shell   /command="x:\OS2\MDOS\COMMAND"
  1335.  
  1336.         where x: is the drive holding your OS/2 directories.
  1337.  
  1338. 2.      If you are using a fossil driver, turn it off.
  1339.  
  1340. 3.      Migrate Waffle to OS/2, and test.
  1341.  
  1342. 4.      If you are using a CRON utility, migrate it, and test.  There
  1343.         are CRON utilities available for OS/2.
  1344.  
  1345.         Personally, I haven't had much luck with OS/2 versions starting
  1346.         DOS programs, but YMMV.  Using a CRON will allow you to let
  1347.         waffle handle the phone, and the second window do all the housework
  1348.         (uuxqt, batching, etc.).
  1349.  
  1350. Once Waffle passes the test, you can begin to tweak.
  1351.  
  1352. o       Install the SIO driver, available wherever fine OS/2 shareware
  1353.         is found.  The latest version is SIO142.ZIP.
  1354. o       Test.
  1355. o       If you must have a fossil, install VX00.SYS from SIO.
  1356. o       Test.
  1357.  
  1358. Once all tests are passed, create a shadow app of Waffle (and your CRON),
  1359. and place it in your Start Up folder.
  1360.  
  1361. TIPS:
  1362. ====
  1363.  
  1364. o       If you have the disk space, and the patience, install wafcnews.
  1365.  
  1366. o       Most sites are using FXUUCICO.  I do not, as I notice no real
  1367.         gain here in throughput, and FX uses a different scheme for the
  1368.         UUCICO log file.
  1369.  
  1370. o       If you install OS2SPEED, set your STATIC multitask entry to
  1371.         multitask: desqview.  If not, set it to multitask: windows.
  1372.  
  1373. DOS SETTINGS:
  1374. ============
  1375.  
  1376. DOS_AUTOEXEC            Create a special batch file containing appropriate
  1377.                         settings for Waffle, (WAFFLE emvironment variable,
  1378.                         etc.)  Do the same for your CRON, or put then in
  1379.                         the same batch file.
  1380.  
  1381. DOS_BACKGROUND_EXECUTION        on
  1382.  
  1383. IDLE_SECONDS            0
  1384.  
  1385. IDLE-SENSITIVITY        Experiment with this on your system.  The default (75)
  1386.                         is way too high.  I have mine set at 3.  Others use
  1387.                         8 or 12.  I suggest using the same setting for all
  1388.                         your DOS and WINDOWS apps.
  1389.  
  1390. INT_DURING_IO           on
  1391.  
  1392. SIO_Allow_Access_COMx   Turn on the com port used by your modem for Waffle.
  1393.                         Turn the rest off.  Turn them all off in your CRON
  1394.                         window.
  1395.  
  1396. SIO_Idle_Sensitivity    Set low.  Mine is at 3.  Experiment for the best
  1397.                         for your system.
  1398.  
  1399. Other SIO settings      Experiment for the best for your system.  Read the
  1400.                         docs.
  1401.  
  1402. VIDEO_MODE_RESTRICTION  CGA.  Increases available memory for waffle, and
  1403.                         your CRON.
  1404. ==end FAQ caption==
  1405.  
  1406.  
  1407. ------------------------------
  1408.  
  1409. Subject: waffle: Waffle and wwivedit
  1410. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  1411.  
  1412. ==begin FAQ caption==
  1413.   From: hannibal@iastate.edu (M. Hannibal Toal)
  1414.   Newsgroups: comp.bbs.waffle
  1415.   Subject: WWIVedit for Waffle FAQ (long)
  1416.   Message-ID: <hannibal.775732078@vincent1.iastate.edu>
  1417.   Date: 1 Aug 94 09:07:58 GMT
  1418.  
  1419. Hi there, I promised this information some time ao, I apologize for the
  1420. delay, but gee, I've been busy :)
  1421.  
  1422. Sorry it's so long, I wanted it to be complete... If anyone would like
  1423. further help or pointers let me know via email.
  1424.  
  1425. I heard there was a new version of WWIVedit? Want to send it to SimTel?
  1426.  
  1427.                                                         hannibal
  1428.  
  1429. cut here ---
  1430.  
  1431.     FAQ for implementing WWIVedit as an external editor for Waffle 1.65
  1432.  
  1433. This works for me. This is exactly how I have it configured right now. Your
  1434. mileage, however, may vary. Note the inclusion of directory and file listings,
  1435. you should have no problems setting it up and putting everything in its place.
  1436.  
  1437. The WWIVedit .DEF file and dirs included here are the ones I use to configure 
  1438. the editor for remote use by my users on my BBS, so it won't let users include
  1439. files, or drop to DOS or other silly things like that. For local applications,
  1440. consult the documentation for information on how to set your preferences.
  1441.  
  1442. I hope people find this information to be useful. Please let me know if there
  1443. is anything that can be included/further explicated/improved.
  1444.  
  1445.                                                         Hannibal
  1446.                                                         SYSTEM 0PERATOR
  1447.                                                         CLU 'Puternet BBS
  1448.                                                         515-232-7631
  1449.  
  1450. Output from "C:\>tree c:\waffle"
  1451. ------------------------------------------------------------------------------
  1452. Directory PATH listing for Volume 'PUTERNET  
  1453. Volume Serial Number is 3A55-1CDC
  1454. C:\WAFFLE
  1455. +---ADMIN
  1456. +---BIN
  1457. +---DOCS
  1458. +---EXTERN
  1459. +---HELP
  1460. +---INFO
  1461. +---MENUS
  1462. +---SYSTEM
  1463. +---TEXT
  1464. +---UUCP
  1465. +---VOTE
  1466. +---WORDS
  1467. +---WWIVEDIT
  1468.     +---CONFIG
  1469.     +---DICT
  1470.     +---DOC
  1471.  
  1472. Note this is exactly the same as suggested in the docs, with the
  1473. exception that WWIVedit is under the WAFFLE directory, not the WWIV
  1474. directory.
  1475.  
  1476.  
  1477. Contents of C:\waffle\extern\_editors: (unwrapped; 4 lines of text)
  1478. ------------------------------------------------------------------------------
  1479. fsed /access=0 /slash /screen /command="c:\waffle\bin\fsed.exe -h21 +c:\waffle\bin\wordstar.cfg +c:\waffle\bin\vt100.cfg %i"
  1480. wwiv /access=0 /screen /command="c:\waffle\wwivedit\wwivedit.exe %i 80 24 100 -key:default -set:default"
  1481. ted /access=9 /screen /local /command="c:\util\ted.com %i"
  1482. wwivedit /access=9 /screen /local /command="c:\waffle\wwivedit\wwivedit.exe %i 80 24 100 -key:local -set:local"
  1483.  
  1484. [wrapped here for the FAQ for those with 80-column problems]
  1485.  
  1486.   fsed /access=0 /slash /screen /command="c:\waffle\bin\fsed.exe -h21
  1487.   +c:\waffle\bin\wordstar.cfg +c:\waffle\bin\vt100.cfg %i"
  1488.  
  1489.   wwiv /access=0 /screen /command="c:\waffle\wwivedit\wwivedit.exe %i 80
  1490.   24 100 -key:default -set:default"
  1491.  
  1492.   ted /access=9 /screen /local /command="c:\util\ted.com %i"
  1493.  
  1494.   wwivedit /access=9 /screen /local
  1495.   /command="c:\waffle\wwivedit\wwivedit.exe %i 80 24 100 -key:local
  1496.   -set:local"
  1497.  
  1498. Contents of C:\waffle\wwivedit\config\default.def
  1499. ------------------------------------------------------------------------------
  1500. ; this is the default configuration for remote users.
  1501. ; I have a local.def for use on the console, with appropriate settings.
  1502. ; You can figure out default.key for yourself, just be sure to wipe
  1503. ; out definitions for include file and shell, leave their definitions
  1504. ; "empty"
  1505. ;                                                        hannibal
  1506. ;
  1507. ; The default settings -- These work for WWIV 4.21a & WWIV 4.22
  1508. ; See CONFIG.DOC for a complete description
  1509. LOCAL:         [N] Whether this is a local definition
  1510. SETUP:         [0] 0=None, 1=CHAIN.TXT, 2=EDITOR.INF (WWIV 4.21a)
  1511. RESULT:        [0] 0=None, 1=RESULT.ED, 2=FEDIT.INF (WWIV 4.21a)
  1512. REPLY:         [0] 0 = Never Ask User
  1513.                    1 = Ask User if E-Mail and user wants to be asked
  1514.                    2 = Ask User if user wants to be asked
  1515. TAG:           [1] Disable User Tag Lines (if 1 or Y)
  1516. BBSTAG:        [N] Disable BBS Tag (if 1 or Y)
  1517. COLORS:      [0-7] Legal Color Range (See CONFIG.DOC for format)
  1518. MCI:            [] Characters treated as MCI chars as per Merlin's Mod
  1519. LINES:         [100,100,100,100,100,100,100,100,100,100,100] 
  1520. KEYBOARD:      [2] 0=XT, 1=AT, 2=Attempt to Auto-Detect
  1521. MONO:          [0] CGA/EGA/VGA, 1=MONO, 2=Auto-Detect first use, 3=Always Aut o
  1522. CHATKEY:        [] L=Left Shift, R=Right Shift, C=Control, A=Alt
  1523.                    LR=Both shifts, CA=Control-Alt, Etc
  1524. DOSKEY:         [] Same Format as ChatKey
  1525. DIVIDER:        [] Filename of the file that contains Tagline divider
  1526. NOTAG:          [] File that contains list of bases to exclude BBS tag from
  1527. NOPERSON:       [] File that contains list of bases to exclude User Tag From
  1528. WARNTIME:     [90] Number of seconds before user is beeped at (0=Never)
  1529. ABORTTIME:   [180] Number of seconds before message auto-aborts
  1530. ESCTICKS:    [350] Increase this if [A [B [C etc starts appearing remotely
  1531. WWIVEDITMACROS:[N] Whether or not WWIVEdit (MACROS.LCL) macros are allowed
  1532. QUOTER:        [0] 0 = None, 1=Goose's Quote 3.01 or greater, 2=WWIV 4.21a
  1533. PERSONALDICT:  [N] Whether or not personal dictionaries should be kept
  1534. COLORTITLE:    [N] Whether or not Color Changes are allowed in the title
  1535. MOUSE:         [N] Y=Allow Mouse Locally
  1536. DIRECTVIDEO:   [N] Must be set to 0/N for Remote use
  1537. SCROLL:        [N] Smooth Scrolling (won't work remotely);
  1538. BBSDISABLE:    [0] If Disable Taglines is set in boardedit, and this is 1,
  1539.                    then User taglines will still work.  If set to 2, user
  1540.                    taglines wont work, but bbs taglines will.
  1541. ; The following shouldn't be modified unless you know what you are doing!
  1542. COMPORT:       [0] Set this to 0 for local and WWIV definitions
  1543. FOSSIL:        [0] 1=Use fossil driver if Comport > 0
  1544. BBS:           [4] 0=None, 1=WWIV (hannibal says note the 4 for waffle! RTFM)
  1545.  
  1546. DESCRIPTION: [The default key bindings for WWIVEdit]
  1547. ESCAPED_KEYS: [#27]
  1548. LOCALONLY: [0]
  1549. MINSL: [0]
  1550. ==end FAQ caption==
  1551.  
  1552.  
  1553.  
  1554. ------------------------------
  1555.  
  1556. Subject: waffle: Waffle and kermit
  1557. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  1558.  
  1559. ==begin FAQ caption==
  1560.   From: gordon@torrie.org (Gordon Torrie)
  1561.   Newsgroups: comp.bbs.waffle
  1562.   Subject: Re: Is it possible to use MSKERMIT?
  1563.   Message-ID: <Fc7Fqc1w165w@torrie.org>
  1564.   Date: Tue, 02 Aug 94 21:20:14 -0400
  1565.  
  1566. Well I am using the real thing, MS-Kermit 3.12. I've posted this 
  1567. before but I guess it is time to do so again.
  1568.  
  1569. To begin--I am using MS-DOS 5.0 on an 80386, Waffle 1.65 and
  1570. MS-Kermit 3.12 at patch level 12.
  1571.  
  1572. The ~\WAFFLE\BIN\RUN.BAT file begins with this line:
  1573.  
  1574. SET KERMIT=ROLLBACK 0
  1575.  
  1576. This minimizes the amount of memory that MS-Kermit will use (by 
  1577. setting the amount of memory used for the display rollback buffer 
  1578. to zero).
  1579.  
  1580. The static file has the following: 
  1581.  
  1582.      device: 2
  1583.      speed:  38400
  1584.      driver: native
  1585.  
  1586. The /waffle/extern/_receive file has the following one-line entry
  1587. in it for Kermit (it is presented here in two lines)
  1588.  
  1589. K  /command="C:\KERMIT\K312\KERMIT def waf take C:\KERMIT\_WAFFLE.TAK,
  1590. DO WAF R %d %b %i"
  1591.  
  1592. The /waffle/extern/_send file has an almost identical line:
  1593.  
  1594. K  /command="C:\KERMIT\K312\KERMIT def waf take C:\KERMIT\_WAFFLE.TAK,
  1595. DO WAF S %d %b %i"
  1596.  
  1597. The Kermit script file, _WAFFLE.TAK, looks like this:
  1598.  
  1599. =====================================================================
  1600. ; This is a Kermit script which will be used when the user wants
  1601. ; Waffle to send or receive files and has selected the Kermit protocol.
  1602.  
  1603. ; The first argument should be either the letter R or S.
  1604. ;
  1605. ;       R - Receive a file
  1606. ;       S - Send a file
  1607.  
  1608. TAKE C:\KERMIT\K312\MSKERMIT.INI
  1609. SET PORT \%2
  1610. SET SPEED \%3
  1611. OUTPUT {MS-DOS Kermit: 3.12  25 Sept 1992 patch level 12\13\10}
  1612. SET ERRORLEVEL 1                  ; Indicate failure (in case we don't succeed)
  1613. IF EQUAL \%1 S GOTO SND
  1614. IF EQUAL \%1 R GOTO RCV
  1615. SET ERRORLEVEL 4                  ; Indicate failure
  1616. EXIT
  1617.  
  1618. :SND
  1619. SEND \%4
  1620. IF SUCCESS SET ERRORLEVEL 0       ; Indicate successful
  1621. EXIT                              ; and return to DOS
  1622.  
  1623. :RCV
  1624. RECEIVE
  1625. IF SUCCESS SET ERRORLEVEL 0       ; Indicate successful
  1626. EXIT                              ; and return to DOS
  1627. =====================================================================
  1628.  
  1629. With this I could send and receive files using Kermit or Zmodem
  1630. and found, as has already been pointed out, that one must tell
  1631. Waffle the exact name of the file to be sent or received if
  1632. Waffle is to report the file transfer as successful.
  1633. ==end FAQ caption==
  1634.  
  1635.  
  1636. ------------------------------
  1637.  
  1638. Subject: waffle: Getting waffle files via mail-based archive servers
  1639. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  1640.  
  1641. ==begin FAQ caption==
  1642.   From: jgostin@eternal.pha.pa.us
  1643.   Newsgroups: comp.bbs.waffle
  1644.   Subject: Monthly Posting: Waffle MBAS List v1.5
  1645.   Message-ID: <gate.775714098$5@eternal.pha.pa.us>
  1646.   Date: Mon, 01 Aug 94 00:08:18 EDT
  1647. ==end FAQ caption==
  1648.  
  1649. the list keeps being updated -- this caption is not the most recent.
  1650.  
  1651.  
  1652. ------------------------------
  1653.  
  1654. Subject: waffle: Getting waffle files via anonymous uucp
  1655. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  1656.  
  1657. ==begin FAQ caption==
  1658.   From: jgostin@eternal.pha.pa.us
  1659.   Newsgroups: comp.bbs.waffle
  1660.   Subject: Monthly Posting: AnonUUCP List v2.3
  1661.   Message-ID: <gate.775714097$4@eternal.pha.pa.us>
  1662.   Date: Mon, 01 Aug 94 00:08:17 EDT
  1663. ==end FAQ caption==
  1664.  
  1665. the list keeps being updated -- this caption is not the most recent.
  1666.  
  1667.  
  1668.  
  1669. ------------------------------
  1670.  
  1671. Subject: waffle: Making waffle menu-driven
  1672. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  1673.  
  1674. ==begin FAQ caption==
  1675.   From: jhart@h5.avcnet.org (Jim Hart)
  1676.   Newsgroups: comp.bbs.waffle
  1677.   Subject: Putting a menu interface on Waffle
  1678.   Message-ID: <857A20C2E46@h5.avcnet.org>
  1679.   Date: Fri, 22 Jul 1994 09:32:32 -0400
  1680.  
  1681. Here it is, for what it's worth.  :-)
  1682. ====================
  1683.  
  1684. Q:  Is there any way for Waffle to have a menu-driven interface?  Is, how?
  1685. A:  Yes.  Here it is:  
  1686.  
  1687. **Disclaimer:  Tom recommends against using the command aliasing
  1688. capability extensively.  I don't know why.  Nevertheless, use of these
  1689. ideas is at your own risk.  It works on _my_ machine, with _my_ setup,
  1690. _so far_.  I make no claims of reliability beyond that.
  1691.  
  1692. Here are the steps I followed and text I used:
  1693.  
  1694.   1.  Make a file in the WORDS subdirectory, called MENU with these contents:
  1695.  
  1696.  
  1697. ...1) Mail
  1698. ...2) News
  1699. ...q) Quit
  1700. ...?) List of commands
  1701.  
  1702.    2.  Make two files in the EXTERN subdirectory named "1" and "2".  "1"
  1703. contains one line:
  1704.  
  1705. /waffle /command="mail" /then=menu
  1706.  
  1707. "2" contains one line:
  1708.  
  1709. /waffle /command=news
  1710.  
  1711.    3.  Make a file in the MENUS subdirectory, called NEWS, which
  1712. contains 9 lines, including a blank line at the top, and no RETURN at
  1713. the end of the last line:
  1714.  
  1715.  
  1716. 1 Edit my newsgroup subscriptions
  1717.     (New users:  the first time, this will subscribe you to
  1718.      a default set of newsgroups)
  1719. 2 Read New news messages
  1720. 3 Read All news messages
  1721. q Quit
  1722.  
  1723. Choice? 
  1724.  
  1725.    4.  Now, make another file in the EXTERN directory, also called NEWS,
  1726. which contains:
  1727.  
  1728. 1 /waffle /command=join /then=menu
  1729. 2 /waffle /command="help scan" /then=newsn
  1730. 3 /waffle /command="help scan" /then=newsr
  1731. q /waffle /command=menu
  1732.  
  1733.    5.  Make another file in the EXTERN directory, called NEWSN, containing:
  1734.  
  1735. /waffle /command=new /then=menu
  1736.  
  1737.    6.  Make another file in the EXTERN directory, called NEWSR, containing:
  1738.  
  1739. /waffle /command=read /then=menu
  1740.  
  1741.    7.  Now, you can either add an instruction to your welcome message like:
  1742.  
  1743. "To have a menu-driven interface, type the command MENU."
  1744.  
  1745. or, you can put a file called WAFFLE in each user's home directory which
  1746. contains the single line:
  1747.  
  1748. menu
  1749.  
  1750. or, you can do both.
  1751.  
  1752. This concept can be extended to make your menus as extensive as you
  1753. want.  The features which make this work are:
  1754.  
  1755. 1.  in externs, you can call Waffle commands, not just external programs
  1756. 2.  calling Waffle commands from an extern goes through the same
  1757. sequence of steps as if the user had typed the command; i.e. the WORDS
  1758. and EXTERN subdirectories are checked for matches
  1759. 3.  externs can contain multiple commands, using a matching file in the
  1760. MENUS subdirectory to prompt the user; this is the part that makes
  1761. submenues possible
  1762.  
  1763. Caveat:  the thing we can't do is make DOS Waffle's mail and news readers
  1764. menu-driven;  their function is built into the code.  Still, hopefully,
  1765. this is a big improvement for new users.
  1766. ==end FAQ caption==
  1767.  
  1768. ==begin FAQ caption==
  1769.   Date: Tue, 16 Aug 1994 21:28:29 -0600
  1770.   From: jhart@h5.avcnet.org (Jim Hart)
  1771.   Subject: Re: Waffle Frequently Asked Questions (FAQ)
  1772.   To: cbwfaq@alpha3.ersys.edmonton.ab.ca (Comp.Bbs.Waffle FAQ)
  1773.   Message-Id: <859350982A6@h5.avcnet.org>
  1774.  
  1775. I think this should be added to the FAQ or my writeup on making Waffle
  1776. menu-driven should be edited.  I now use this technique for the main
  1777. menu on my board.
  1778. ----------------------------
  1779. Vlaad Thunarsson wrote:
  1780.  
  1781. > a really neat way to do this is to make a short menu and put it in your
  1782. > zippy quotes..(waffle\system\zippy - j.h.) then you copy the menu about
  1783. > 5 times or so in that same file so it will actually work. <a problem
  1784. > with the random thing needing several entries in order to function>  You
  1785. > then put a %z ... in your prompt string somewhere.. guess what? Now the
  1786. > user sees a short menu every time they get a prompt.. Neato, huh?  Try
  1787. > it.. You'll LIKE it.
  1788. -----------------------------------------
  1789. I do like it, very much, and there is no limit to the menu length, near
  1790. as I can tell, because the zippy entries are delimited by the "pipe"
  1791. character.
  1792. ==end FAQ caption==
  1793.  
  1794. ==begin FAQ caption==
  1795.   From: jhart@h5.avcnet.org (Jim Hart)
  1796.   Subject: Re: stack overflow
  1797.   Message-Id: <85B34A4654C@h5.avcnet.org>
  1798.   Date: Sat, 17 Sep 1994 19:38:02 -0600
  1799.  
  1800.   There has been a little discussion on c.b.w regarding use of this
  1801. technique.  It turns out that too much of calling externs with externs
  1802. results in a "stack overflow" error, thus bombing Waffle.  I have been
  1803. trying to find ways around the problem.  I will write up and post my
  1804. findings, along with info from others on the issue, as soon as I can
  1805. find the time.  In the meantime, perhaps the next issue of the FAQ
  1806. should mention that overuse of the technique I suggested results in
  1807. the aforementioned error.  Reliability is, therefore, suspect, since
  1808. the sysop has no control of how much jumping around from menu to menu
  1809. that a user will do.
  1810. ==end FAQ caption==
  1811.  
  1812.  
  1813. ------------------------------
  1814.  
  1815. Subject: waffle: What can i do about uuxqt/rnews hanging on long Path: headers?
  1816. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  1817.  
  1818. 1. move to waffle cnews, or some other package which doesn't
  1819.    scribble all over memory on long headers
  1820.  
  1821.    cnews-dos     simtel:waffle/wcnw105c.zip
  1822.  
  1823. 2. run batscan (or use the -b switch in ruuxqt)
  1824.  
  1825. ==begin FAQ caption==
  1826. -- 
  1827. Roy M. Silvernail                             roy@sendai.cybrspc.mn.org
  1828.               Keeping Waffle Irons hot since 1989
  1829.            Run Waffle?  Rnews locking up?  You need BSCAN!
  1830. echo /get /pub/waffle/bscan26.zip | rmail file-request@cybrspc.mn.org
  1831. ==end FAQ caption==
  1832.  
  1833.    batscan       ftp.halcyon.com:/pub/waffle/news/bscan26.zip
  1834.  
  1835.  
  1836. ------------------------------
  1837.  
  1838. Subject: waffle: Why do i get Error 5 deleting call file?
  1839. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  1840.  
  1841. ==begin FAQ caption==
  1842.   From: jorge@laser.satlink.net (Jorge Cwik)
  1843.   Newsgroups: comp.bbs.waffle
  1844.   Subject: Re: UUCICO - Error 5 deleting call file.
  1845.   Message-ID: <FB78qc1w165w@laser.satlink.net>
  1846.   Date: Thu, 18 Aug 94 00:12:26 -0400
  1847.  
  1848. > When I poll him, no problems occur.  However, when he polls me, some
  1849. > information goes across and then we end up in a loop.  The UUCICO file
  1850. > continually says:  Error 5 deleting call file, nnnnnn.cmd.
  1851.  
  1852. It's a known bug (should be in the FAQ).
  1853.  
  1854. Unload SHARE if possible, or switch to FX uucico.
  1855. ==end FAQ caption==
  1856.  
  1857.  
  1858. ------------------------------
  1859.  
  1860. Subject: waffle: What is the difference between access level and privelege level?
  1861. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  1862.  
  1863. AccessLevel controls one thing.  PrivelegeLevel controls another.
  1864.  
  1865. From an account with AccessLevel 9 and PrivelegeLevel 0, you can not do
  1866. things that would compromise security (e.g., mess with other users'
  1867. files, get a DOS command prompt, use the admin command).  Do not give
  1868. your users high PrivelegeLevels unless you really, really trust them.
  1869.  
  1870. Repeat:  be careful with PrivelegeLevel.
  1871.  
  1872. ------------------------------
  1873.  
  1874. Subject: waffle: Why does waffle complain about `truncated batch'?
  1875. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  1876.  
  1877. if people post news with ASCII 13s (Carriage Returns) in them on
  1878. certain sites which aren't expecting it, they get propogated where
  1879. they shouldn't be.  waffle's rnews counts them in one part of the
  1880. code but misses them in another part of the code, and if the two
  1881. counts don't match, gives this error.
  1882.  
  1883. of course, it could be that you really did get an incomplete batch.
  1884. if so, retransmit.
  1885.  
  1886. ------------------------------
  1887.  
  1888. Subject: waffle: How can I set up a mailing list?  Waffle won't let me have more than 20?
  1889. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  1890.  
  1891. you can't have more than 20 addresses in an alias in /waffle/system/aliases.
  1892. but there is cheap (and free) software to handle complex automated mail tasks.
  1893.  
  1894. check the comp.os.msdos.mail-news FAQ for mail-based archive servers.
  1895. These are known to work with waffle:
  1896.    wfs
  1897.    v-mailserver
  1898.    aser
  1899.  
  1900. some can do a lot of neat things for you besides handling a mailing list.
  1901.  
  1902. ------------------------------
  1903.  
  1904. Subject: waffle: How can I set up a info@ auto-reply mechanism?
  1905. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  1906.  
  1907. see the previous answer about mail servers.
  1908.  
  1909. ------------------------------
  1910.  
  1911. Subject: waffle: What changes are needed for the new free BSD systems?
  1912. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  1913.  
  1914. this info comes From: ramp@suspects.com (ramp)
  1915.  
  1916. make sure cc is always called with -traditional
  1917.  
  1918. In unix.c, under '#ifdef BSD', add:
  1919.   #include <curses.h>
  1920.  
  1921. In waffle.h:
  1922.   change the #defines for TRUE and FALSE to
  1923.     TRUE (1)
  1924.     FALSE (0)
  1925.  
  1926. In /tools, make this change to setname.c:
  1927.   while (loc = tell(fd),...
  1928.   Change `tell' to `ftell'.
  1929.  
  1930. ------------------------------
  1931.  
  1932. Subject: waffle: How can I get RIP graphics on waffle for $2?
  1933. From: cbwfaq@alpha3.ersys.edmonton.ab.ca
  1934.  
  1935. ==begin FAQ caption==
  1936.   From: root@Cheese.LunaCity.com (Stephen Lau)
  1937.   Subject: RIP/ANSI on Waffle?!?!? - Its true!
  1938.   Message-ID: <eD8LZc1w165w@Cheese.LunaCity.Com>
  1939.   Date: Fri, 27 Jan 95 17:30:25 PST
  1940.  
  1941. I've released WafTerm v2.01, for Waffle BBSs, but it will also
  1942. work with *ANY* BBS that can support running external 'doors'
  1943.  
  1944. It allows Waffle (and other most BBSs) to support RIP and ANSI
  1945. graphics.  The way it works is, you put a command in your _SYSTEM
  1946. file, for LOGIN, and have it run a batch file.  The batch file
  1947. should run WafTerm, and WafTerm will then exit with errorlevel [...]
  1948.  
  1949. In the archive package, there are sample _SYSTEM files, and a
  1950. batch file for you to run, so, all you have to do is configure
  1951. the paths in the _SYSTEM, and the .BAT file!
  1952.  
  1953. And best of all..its only $2.00 (US) to register!  Only $2.00
  1954. for great looking interface screens, which your users will love!
  1955.  
  1956. I have no currrent FTP support site, but you can email:
  1957. WafTerm@Cheese.LunaCity.Com for a free, uuencoded copy.
  1958. ==end FAQ caption==
  1959.  
  1960. === thus endeth the Waffle FAQ
  1961.